home *** CD-ROM | disk | FTP | other *** search
/ Zoom 2 / Zoom - Release 2 (1996)(Active Software)[!].iso / programming / amos / guiamos / guidocument < prev   
Encoding:
Text File  |  1978-03-20  |  33.3 KB  |  1,178 lines

  1. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2. >                                       >
  3. >   >>>>>>>>>>  >    >  >>>>>>>  >>>>>>>>                   >    
  4. >   >           >       >     >     >       >                        >
  5. >   >           >    >     >     >      >                   >
  6. >   >        >    >     >     >       >                               >
  7. >   >        >    >     >     >      >   >>> >>>    >>>>>    >>>>>   >
  8. >   >    >    >    >     >     >>>>>>>>  >   >   >  >     >  >       >
  9. >   >    >>>>    >    >     >     >      >  >       >  >     >  >        >
  10. >   >    >  >    >    >     >     >      >  >       >  >     >   >>>>>   >
  11. >   >        >    >    >     >        >      >  >       >  >     >       >   >
  12. >   >>>>>>>>>>   >>>>>>>   >>>>>>>  >      >  >       >   >>>>>   >>>>>    >
  13. >                                         >
  14. >**************************************************************************>
  15. >*******************COPYRIGHT 1995©® (Level 9 Software)********************>
  16. >**************************************************************************>
  17.  
  18. Thanks for purchasing this from your PD library, you can freely distribute 
  19. this program, as long as this document and all other files on the disk are
  20. present, and no money is gained, other than the cost of the disk it is
  21. distributed on.
  22.  
  23. Even though this program is freely distributable, it has taken 3 months of 
  24. hard work, & I would be grateful for any feedback 
  25. (money!, postcards, any Amos code or programs written in GUIAmos).  
  26.  
  27. Thanks!
  28.  
  29. My address is.........
  30.  
  31. Andrew Fisher
  32. Level 9 Software
  33. Ingleside
  34. 60 Burgh Lane
  35. Mattishall
  36. E Dereham
  37. Norfolk
  38. NR20 3QR
  39.  
  40.  
  41. >*************************************************************************>
  42.  
  43. (Unfortunately this program saves out ascii text that is only FULLY 
  44. compatible with AMOSPro, but some of the Gadgets are compatable with the
  45. other versions of Amos, (see list below)
  46.  
  47. What is it?
  48.  
  49. When I write programs in amos, I find it increasingly difficult to create
  50. a decent interface that is easy to use and quick to put together, the
  51. interface used to take longer than writing the main code!!  
  52.  
  53. Therefore I decided to make GUIAmos (Graphical User Interface Amos), it aids
  54. you in the design of your interface's, including....
  55.  
  56. GADGET:            COMPATIBLE VERSIONS
  57.  
  58. 6 Types of Bevel Box    (All versions)
  59. Buttons                 (All Versions)
  60. Tick Box's         (All Versions)
  61. Block Box's        (All Versions)
  62. Horozontal Sliders    (Amos Pro/Amos 1.1+)
  63. Horozontal Scrollers    (Amos Pro/Amos 1.1+) 
  64. Vertical Sliders    (Amos Pro/Amos 1.1+) 
  65. Vertical Scrollers      (Amos Pro/Amos 1.1+) 
  66. Text zones        (Amos Pro)
  67. Number zones        (Amos Pro)
  68. GetFile                 (All Versions)
  69. Toggle gadgets          (All Versions) 
  70. Menus            (All Versions)    
  71.  
  72. When you have set out your interface you can save out the code as ascii text,
  73. and import it into Amos.
  74.  
  75. You can then add the rest of your code to the gadgets and your next super
  76. utility is winging it's way to the PD librarys! Easy!
  77.  
  78. Remember ** You will recieve any GUIAmos Updates, FREE of charge! ***
  79.  
  80. **************************************************************************
  81.  
  82. THINGS YOU SHOULD KNOW:
  83.  
  84. You can turn the rather slow but useful Cross pointer on/off by pressing 
  85. the DEL button
  86.  
  87. There is also Online Help by pressing HELP
  88.  
  89. Drawing screen = The screen that is blank when you load GUIAmos, this is 
  90. where the graphics (Buttons etc) are drawn .
  91.  
  92. Icon Screen = The screen that has all of the coordinates of the mouse 
  93. pointer, sizes of box's etc, and the icons representing each gadget.
  94.  
  95. **************************************************************************
  96.  
  97. HOW TO START GUIAmos:
  98.  
  99. You can run GUIAmos from Hard Drive or Floppy, to install onto HD just
  100. drag it into the draw you want it to load from.
  101.  
  102. Double click on it's Icon, after a few secs you will be presented with a
  103. screen showing the Level 9 Software logo, (click the mouse button).
  104.  
  105. >>>>>>>>>>>
  106.  
  107. You will now see a screen showing different screen resouloutions (Written
  108. in GUIAmos).
  109.  
  110. Click on your desired resouloution and the maximum number of colours
  111. (4 is the minimum, because they are needed for the 3D look buttons etc).
  112.  
  113. When you are sure, click on the button marked (Start GUIAmos)
  114.  
  115. >>>>>>>>>>>
  116.  
  117. Prefs:
  118.  
  119. You will then see another screen, (Sorry about all of these separate screens
  120. but it keeps things simple!), this is the preferences screen.
  121.  
  122. Here are the prefs you can set:
  123.  
  124. Detect Zones: (Tick Box)
  125.  
  126. If the tick is in the box it means that GUIAmos will automatically check if
  127. you place a gadget on top of another gadget (It slows the program down
  128. though).  If you can manage without this checking, and want the extra speed
  129. leave it off!
  130.  
  131. >>>>>>>>>>>
  132.  
  133. Set Zone loop: (Tick box)
  134.  
  135. If the tick is not in the box it means that when the code is saved out the
  136. part of the code where the zones are set will be like this...
  137.  
  138. eg.
  139.  
  140. Reserve Zone 34
  141.  
  142. Set Zone 1,10,32 to 90,70
  143. Set Zone 2,90,29 to 190,78
  144. Set Zone 3,5,10 to 34,32
  145. |
  146. ** Up to 34 **
  147.  
  148. But if it is ticked it will appear like this (more compact)...
  149.  
  150. Reserve Zone  34
  151. For I=1 To 34
  152. If TYPE(I)=1 or TYPE(I)=4 or TYPE(I)=6 or TYPE(I)=7 or TYPE(I)=23
  153. Set Zone i,X1(i),Y1(i) To X2(i),Y2(i)
  154. End If 
  155. Next I
  156.  
  157. >>>>>>>>>>>
  158.  
  159. Rems in code: (Tick Box)
  160.  
  161. If this gadget is ticked it means that all of my remarks (to explain the
  162. final code), will be in the code.  But if it is off, they will not be
  163. saved along with the code (i.e when you know how the program works and
  164. don't need my feeble remarks!).
  165.  
  166. >>>>>>>>>>>
  167.  
  168. Save Zone List: (Tick Box)
  169.  
  170. If this is ticked a seperate ascii file will be created which will aid
  171. you in knowing what each and every Amos Zone (using the Set Zone command)
  172. is. (it will be saved as (file.ZONES), where file is, this will be your file
  173. name).
  174.  
  175. NOTE: The Text/Numric zones do not use Amos zones so will be displayed
  176.       as (Variable 1) etc.
  177.  
  178. e.g 
  179.  
  180. EACH OF THE ZONES AND THERE GADGETS
  181.  
  182. ( 1) A Button
  183. ( 2) A Tick Box,Type=Tick,Status=Off
  184. ( 3) A Tick Box,Type=Tick,Status=On
  185. ( 4) A Tick Box,Type=Block,Status=Off
  186. ( 5) A Tick Box,Type=Block,Status=On
  187. ( 6) A Horozontal Slider,Divs= 80,Pos 1
  188. ( 7) A Vertical Slider,Divs= 86,Pos 1
  189.  
  190. (The numbers in brackets are the Zone numbers)
  191.  
  192. >>>>>>>>>>>
  193.  
  194. Tick Box XSize: (Slider)
  195.  
  196. If you drag this slider it will adjust the X size of the tick box
  197. and the newly sized Tick box is displayed at the bottom of the screen
  198.  
  199. >>>>>>>>>>>
  200.  
  201. Tick Box YSize: (Slider)
  202.  
  203. If you drag this slider it will adjust the Y size of the tick box
  204. and the newly sized Tick box is displayed at the bottom of the screen
  205.  
  206. >>>>>>>>>>>
  207.  
  208. Get file Xsize: (Slider)
  209.  
  210. If you drag this slider it will adjust the X size of the getfile gadget
  211. and the newly sized Getfile is displayed at the bottom of the screen
  212.  
  213. >>>>>>>>>>>
  214.  
  215. Get File YSize: (Slider)
  216.  
  217. If you drag this slider it will adjust the Y size of the getfile gadget
  218. and the newly sized Getfile is displayed at the bottom of the screen
  219.  
  220. >>>>>>>>>>>
  221.  
  222. WB Look title bar: (Tick Box)
  223.  
  224. When selected this draws a bar, similar to the one on the wb screen
  225.  
  226. >>>>>>>>>>>
  227.  
  228. Auto Save IFF a GUI: (Tick Box)
  229.  
  230. Automatically saves the Iff file with the file name "GUI", otherwise
  231. it will ask you for a name.
  232.  
  233. Press Go!
  234.  
  235. And the program will start.
  236.  
  237. **************************************************************************
  238.  
  239. HOW TO USE THE EDITOR:
  240.  
  241. I will now explain all of the buttons and options involved in GUIAmos, 
  242. including the variables that the gadget affects in the finished code.
  243.  
  244. These are the icons from left to right......
  245.  
  246. **************************************************************************
  247.  
  248. BUT (ICON) (key Shortcut (B)) 
  249.  
  250. Click left on this icon and you can draw a (thin) 3d box on the drawing 
  251. screen, that will transform into a button, when you import it into the 
  252. Editor. Click right and same as above but (Thick 3d box).
  253.  
  254. Affected Variables:
  255.  
  256. TYPE = Type of gadget (Thin (1), Thick (80)) 
  257. X1=Starting x position of the button
  258. Y1=Starting y position of the button
  259. X2=Ending x position of the button
  260. Y2=Ending y position of the button
  261. eg.
  262.          Y1
  263.        X1**********
  264.          *        *
  265.          *        *
  266.          **********X2
  267.                  Y2
  268.  
  269. **************************************************************************
  270.  
  271. Bevel Box (Out): (Key shortcut (O))
  272.  
  273. Click on the Bevel Box icon until you reach the disired Type of Bevel, 
  274. there are 3 to choose from. and with the mouse pointer over the drawing
  275. screen hold down the left mouse button and drag the box out to your 
  276. required size.
  277.  
  278. ***************************************************************************
  279.  
  280. Bevel Box (In): (Key shortcut (I))
  281.  
  282. Click on the Bevel Box icon until you reach the disired type of bevel, 
  283. there are 3 to choose from and with the mouse pointer over the drawing
  284. screen hold down the left mouse button and drag the box out to your 
  285. required size.
  286.  
  287. ***************************************************************************
  288.  
  289. Toggle (Key Shortcut (T))
  290.  
  291. Click on the Toggle icon, and with the mouse pointer over the drawing
  292. screen hold down the left mouse button and drag the box out to your 
  293. required size.
  294.  
  295. You will then be asked how many toggles the toggle box will cycle through
  296.  
  297. e.g
  298.  
  299. If you wanted it to toggle between On & Off, this would be 2 toggles.
  300.  
  301. When you have typed the number of toggles and pressed return, you will
  302. be presented with another screen, with the required number of text edit
  303. zones.  The first one is the default text, the second is the next piece 
  304. of text to appear, and so on.
  305.  
  306. Just type in the text you want and press the DONE button or press escape
  307. on the keyboard, to cancel the toggle gadget.
  308.  
  309. Affected Variables
  310. TYPE() = Type of gadget (22) 
  311. PS() = Holds the current toggle number
  312. TGLES() = Holds the number of toggles to cycle through
  313. X1=Starting x position of the button
  314. Y1=Starting y position of the button
  315. X2=Ending x position of the button
  316. Y2=Ending y position of the button
  317. eg.
  318.          Y1
  319.        X1**********
  320.          *        *
  321.          *        *
  322.          **********X2
  323.                  Y2
  324.  
  325. ***************************************************************************
  326.  
  327. IFF S (Save the drawing screen as an iff) (Key shortcut (Shift S)
  328.  
  329. This saves the drawing screen as an Iff picture, when you click on the icon
  330. you will be required to click choose the file name to save it as.
  331.  
  332. *************************************************************************** 
  333.  
  334. ? (Info) (Key Shortcut (?))
  335.  
  336. If you click on this icon, you will be shown a screen identical to the 
  337. one in the copy function, if you run the pointer over the gadget you 
  338. will be given all the information you need about it.
  339.  
  340. **************************************************************************
  341.  
  342. Del (Delete) (Key shortcut (d))
  343.  
  344. If you click on this icon you will be represented with the same info
  345. bar as with the Copy/Info tools, if you click on a gadget it will be
  346. totally destroyed, including all variables
  347.  
  348. ****WARNING**** You cannot undo after deletion *******
  349.  
  350. **************************************************************************
  351.  
  352. Horozontal Slider: (Key shortcut (h)
  353.  
  354. To place a horozontal slider on the screen, select the icon and with the 
  355. mouse in the drawing screen hold down the left mouse button and drag a
  356. box (this will be the slider!).
  357.  
  358. You will then be presented with another screen, it will ask you..
  359.  
  360. Type the no. of units the bar is divided into..(Min 2)
  361.  
  362. You can then type a number between those values and the slider will be 
  363. divided into that number. Press return to enter the value.
  364.  
  365. You will then be asked....
  366.  
  367. Type the start position of the slider..(1-Amount)
  368. (where amount is, is the amount the slider is devided into)
  369.  
  370. You can then type the start position that the slider will start at.
  371. Press return to enter the value.
  372.  
  373. Affected Variables:
  374.  
  375. Type = Type of gadget (7)
  376. X1 = Starting x position of the Slider
  377. Y1 = Starting y position of the Slider
  378. X2 = Ending x position of the Slider
  379. Y2 = Ending y position of the Slider
  380. _TOT() = The number of division the slider is divided into
  381. POS() = The start position (At begining), and current position of 
  382.         the slider
  383.  
  384. *************************************************************************** 
  385.  
  386. Vertical Slider: (Key shortcut (v)
  387.  
  388. To place a Vertical slider on the screen, select the icon and with the 
  389. mouse in the drawing screen hold down the left mouse button and drag a
  390. box (this will be the slider!).
  391.  
  392. You will then be presented with another screen, it will ask you..
  393.  
  394. Type the no. of units the bar is divided into..(Min 2)
  395.  
  396. You can then type a number between those values and the slider will be 
  397. divided into that number.  Press return to enter the value.
  398.  
  399. You will then be asked....
  400.  
  401. Type the start position of the slider..(1-Amount)
  402. (Where Amount is, is the Amount of divisions the slider is devided into)
  403.  
  404. You can then type the start position that the slider will start at.
  405. Press return to enter the value.
  406.  
  407. Variables:
  408.  
  409. Type = Type of gadget (6)
  410. X1 = Starting x position of the Slider
  411. Y1 = Starting y position of the Slider
  412. X2 = Ending x position of the Slider
  413. Y2 = Ending y position of the Slider
  414. _TOT() = The number of division the slider is divided into
  415. POS() = The start position (At begining), and current position
  416.         of the slider
  417.  
  418. ***************************************************************************
  419.  
  420.  
  421. Horozontal Scroller: (Key shortcut (Shift H))
  422.  
  423. Firstly you will notice Four tiny Icons, named T,B,L,R
  424.  
  425. The last two L & R, stand for Left and right, if you click on either
  426. of these, it will change the position of the Scroller arrows, on either
  427. the left or the right of the slider.
  428.  
  429. >>>>>>
  430.  
  431. To place a horozontal scroller on the screen..
  432.  
  433. Select the Horozontal slider icon with the RIGHT mouse button 
  434. Move the mouse around in the drawing screen, you will see a box already on 
  435. the screen, this is representing the Scroll icons on the end of the slider.
  436.  
  437. Hold your left mouse button down and drag a box out, this is the slider. 
  438.  
  439. You will then be presented with another screen, it will ask you..
  440.  
  441. Type the no. of units the bar is divided into..(Min 2)
  442.  
  443. You can then type a number between those values and the slider will be 
  444. divided into that number. Press return to enter the value.
  445.  
  446. You will then be asked....
  447.  
  448. Type the start position of the slider..(1-Amount)
  449. (where amount is, is the amount the slider is devided into)
  450.  
  451. You can then type the start position that the slider will start at.
  452. Press return to enter the value.
  453.  
  454. GUIAmos will then draw the slider, and the scroller arrows on the side you 
  455. have selected.
  456.  
  457. Affected Variables:
  458.  
  459. Type = Type of gadget (7 for H slider & Hscroll=34)
  460. X1 = Starting x position of the Slider
  461. Y1 = Starting y position of the Slider
  462. X2 = Ending x position of the Slider
  463. Y2 = Ending y position of the Slider
  464. _TOT() = The number of division the slider is divided into
  465. POS() = The start position (At begining), and current position of 
  466.         the slider
  467.  
  468. *************************************************************************** 
  469.  
  470. Vertical Scroller: (Key shortcut (Shift V))
  471.  
  472. Firstly you will notice Four tiny Icons, named T,B,L,R
  473.  
  474. >>>>>>>
  475.  
  476. The first two T & B, stand for Top and Bottom, if you click on either
  477. of these, it will change the position of the Scroller arrows, on either
  478. the Top or the Bottom of the slider.
  479.  
  480. >>>>>>
  481.  
  482. To place a Vertical scroller on the screen..
  483.  
  484. Select the Vertical slider icon with the RIGHT mouse button 
  485. Move the mouse around in the drawing screen, you will see a box already on 
  486. the screen, this is representing the Scroll icons on the end of the slider.
  487.  
  488. Hold your left mouse button down and drag a box out, this is the slider. 
  489.  
  490. You will then be presented with another screen, it will ask you..
  491.  
  492. Type the no. of units the bar is divided into..(Min 2)
  493.  
  494. You can then type a number between those values and the slider will be 
  495. divided into that number. Press return to enter the value.
  496.  
  497. You will then be asked....
  498.  
  499. Type the start position of the slider..(1-Amount)
  500. (where amount is, is the amount the slider is devided into)
  501.  
  502. You can then type the start position that the slider will start at.
  503. Press return to enter the value.
  504.  
  505. GUIAmos will then draw the slider, and the scroller arrows on the side you 
  506. have selected.
  507.  
  508. Affected Variables:
  509.  
  510. Type = Type of gadget (6 for H slider & Vscroll=35)
  511. X1 = Starting x position of the Slider
  512. Y1 = Starting y position of the Slider
  513. X2 = Ending x position of the Slider
  514. Y2 = Ending y position of the Slider
  515. _TOT() = The number of division the slider is divided into
  516. POS() = The start position (At begining), and current position of 
  517.         the slider
  518.  
  519. **************************************************************************
  520.  
  521. Tick Box: ((Key shortcut (z))
  522.  
  523. Click on the icon and with the mouse pointer on the drawing screen, hold 
  524. down the left mouse button and you can drag the tick box sized box around
  525. the screen.  When it is the correct position, let go of the the mouse
  526. button. 
  527.  
  528. To toggle the tick on the tick box (On / Off) press the right mouse button
  529. over the Tick box icon.
  530.  
  531. To toggle the Tick to a Block, click the left mouse button over the tick
  532. box icon.
  533.  
  534. *** (The tick is not shown until the finished code is ported into amos!)** 
  535.  
  536. Variables:
  537.  
  538. TYPE() = ID Number of the gadget (4)
  539. TY() = Returns a (1) if it is a tick and a (0) if it is a Block 
  540. _ONOF() = Returns a (1) if tick is on and a (0) if it is off
  541. These are used to draw the ticks/Blocks inside the boxes
  542. X1 = Starting x position of the Tick Box
  543. Y1 = Starting y position of the Tick Box
  544. X2 = Ending x position of the Tick Box
  545. Y2 = Ending y position of the Tick Box
  546.  
  547. ***************************************************************************
  548.  
  549. Get File: (Key Shortcut(f))
  550.  
  551. Click on the icon and with the mouse pointer on the drawing screen, hold 
  552. down the left mouse button and you can drag the Get File sized box around
  553. the screen.  When it is the correct position, let go of the the mouse
  554. button. 
  555.  
  556. Afected variables:
  557. TYPE() = ID Number of the gadget (23)
  558. FILE$() = Stores the file name that is selected
  559.  
  560. ***************************************************************************
  561.  
  562. IFF L (Loads a previous iff image onto the drawing screen)
  563. (Key Shortcut (Shift L))
  564.  
  565. This loads an Iff picture into the drawing screen, when you click on the icon
  566. you will be required to click choose the file name to load.
  567.  
  568. You will then be warned that this will destroy all of you zones and 
  569. everything to do with your previous GuiAmos Program (So save it first!)
  570.  
  571. **************************************************************************
  572.  
  573. ED (Edit the Tick Boxes, Sliders, Toggle ) (e)
  574.  
  575. This is the edit function, select this and you will then see a black 
  576. screen with white text.
  577.  
  578. Heres what information appears in that screen when you move the pointer 
  579. over a.......
  580.  
  581. Tick Box:
  582.  
  583. Zone number
  584. Xstart/Ystart
  585. Xfinish/YFinish
  586. Type of Gadget as a (Tick Box) 
  587. Tick On/Off (Whether the tick is on or off on startup)
  588. Tick Tick/Block (Whether the tick is a Tick or Block)
  589.  
  590. To edit a Tick Box...
  591.  
  592. Click on the Tick box you want to edit, and a screen will apear with... 
  593.  
  594. Some Buttons..
  595.  
  596. Tick On --|Click on one of these two to change whether the tick is on
  597. Tick Off--|or off as default.
  598.  
  599. Tick------|Click on one of these two to change whether the tick is a tick
  600. Block-----|or a block
  601.  
  602. Which ever you click on, the prefs will be displayed to the left.
  603.  
  604. Click on ok to return back to GUIAmos.
  605.  
  606. *********
  607.  
  608. Sliders (Horozontal/Vertical):
  609.  
  610. Zone number
  611. Xstart/Ystart
  612. Xfinish/YFinish
  613. Type of Gadget as a (H/V Slider) 
  614. No. Divisions (The number of divisions in that slider)
  615. Start Pos. (The Position of the slider at the start of the finished prog)
  616.  
  617. To Edit the Slider:
  618.  
  619. Click on the slider you want to edit...
  620.  
  621. You will then be presented with another screen, it will ask you..
  622.  
  623. Type the no. of units the bar is divided into..(Min 2)
  624.  
  625. You can then type a number and the slider will be 
  626. divided into that number. 
  627.  
  628. You will then be asked....
  629.  
  630. Type the start position of the slider..(1-Amount)
  631. (Where Amount is, is the Amount the slider is devided into)
  632.  
  633. You can then type the start position that the slider will start at.
  634. (If you press the return key, without a value, it will default to (1))
  635.  
  636. ***********
  637.  
  638. To Edit a toggle gad:
  639.  
  640. Click on the toggle gad you want to edit, and the same screen will appear,
  641. as when you first created you toggle gad.
  642.  
  643. **** Please do NOT use these characters in the text "'" and "`" ***** 
  644.  
  645. ***************************************************************************
  646.  
  647. L (Load GUIAmos Code) (Key shortcut (L)
  648.  
  649. If you click on this you will be required to choose a (.dat file) of a
  650. previous GUIAmos program.
  651.  
  652. It will then ask if you want to load the default file name ("GUI") or 
  653. another.  If you choose ("GUI"), it will try and find the ("GUI") file
  654. in the same directory, if it can't find it you will have to choose the 
  655. correct one yourself.
  656.  
  657. **************************************************************************
  658.  
  659. S (Save GUIAmos Code) (Key shortcut (S))
  660.  
  661. If you have choosen AUTO SAVE GUI in the prefs screen, it will save 
  662. the Iff image ("GUI"), otherwise it will ask you for a name for the iff
  663. image. It will save all the data ("NAME.dat")
  664. and the Ascii code ("NAME.ASC").
  665.  
  666. *** Don't Include the ".ASC" it is added for you ****
  667.  
  668. **************************************************************************
  669.  
  670. Text Editing Zone: (Key shortcut (A))
  671.  
  672. To create an Editing zone, click on it's icon, and with the mouse pointer
  673. over the drawing screen, hold down the left mouse button and drag the box
  674. right.  When you have the Zone in the correct place, let go of the mouse
  675. button and it will be drawn onto the drawing screen.
  676.  
  677. You will then be asked...
  678.  
  679. Type the max number of charecters (LEN - 200)
  680. (Where the LEN is, this is the length in charecters of you zone)
  681.  
  682. You can then type the maximum number of charecters that the Edit zone can 
  683.  
  684. You will then be asked...
  685.  
  686. Type the default text.. 
  687.  
  688. Unfortunately, when drawing the zone, the X starting position has to be 
  689. a multiple of 16, and the width of the zone has to be multiples of 8. 
  690. Sorry! (I suggest you create these first to fit the other gadgets in!)
  691.  
  692. Variables:
  693.  
  694. X1 = Starting x position of the Zone
  695. Y1 = Starting y position of the Zone
  696. X2 = Ending x position of the Zone
  697. Y2 = Ending y position of the Zone
  698. _LEN() = The actual length of the zone in characters
  699. _MAXLEN() = The Maximum length in characters of the zone
  700. _DEF$() = The default text of the Zone
  701.  
  702. To get the text from this to use in your program, use this command...
  703.  
  704. S$=rdialog$(1,Zone)
  705.  
  706. S$   = The string variable it will be stored in 
  707. Zone = The zone number of the edit gadget
  708.  
  709. (Look in your manual for more info!)
  710.  
  711. ***************************************************************************
  712.  
  713. Number Editing Zone: (Key shortcut (1))
  714.  
  715. To create an Number Editing zone, click on it's icon, and with the mouse 
  716. pointer over the drawing screen, hold down the left mouse button and drag 
  717. the box right.  When you have the Zone in the correct place, let go of the 
  718. mouse button and it will be drawn onto the drawing screen.
  719.  
  720. You will then be asked...
  721.  
  722. Type the default Number (1-LEN).. 
  723. (1- the Length in characters of the zone (Max 9 numbers))
  724.  
  725. Unfortunately, when drawing the zone, the X starting position has to be 
  726. a multiple of 16, and the width of the zone has to be multiples of 8, also
  727. the length can't be any more than 9 numbers.  Sorry! (I suggest you create 
  728. these first to fit the other gadgets in!).
  729.  
  730. X1 = Starting x position of the Zone
  731. Y1 = Starting y position of the Zone
  732. X2 = Ending x position of the Zone
  733. Y2 = Ending y position of the Zone
  734. _LEN() = The actual length of the Num Zone in characters
  735. _MAXLEN() = 1 (Not needed for the num zone)
  736. _DEF$() = The default number of the Zone
  737.  
  738. To get the text from this to use in your program, use this command...
  739.  
  740. S=rdialog(1,Zone)
  741.  
  742. S    = The variable it will be stored
  743. Zone = The zone number of the edit gadget
  744.  
  745. (Look in your manual for more info!)
  746.  
  747. **************************************************************************
  748.  
  749. SCISSORS (ICON): (Key shortcut (c))
  750.  
  751. This is the copy function, select this and you will then see a black 
  752. screen with white text.
  753.  
  754. Heres what information appears in that screen when you move the pointer 
  755. over a.......
  756.  
  757. **************
  758.  
  759. Button:
  760.  
  761. Info Displayed...
  762.  
  763. When you have the pointer over the Button you want to copy, it will 
  764. display the...
  765.  
  766. Zone number
  767. Xstart/Ystart
  768. Xfinish/Yfinish 
  769. Type of Gadget as a (3D Button).
  770.  
  771. Copying a button..
  772.  
  773. Click on the button with your left mouse key and hold it down, you will
  774. now be able to move a box (The same size as the selected button) around 
  775. the screen. When you have the button in the right place let go of the left
  776. mouse button and it will be placed on the screen.
  777.  
  778. **************
  779.  
  780. Tick Box:
  781.  
  782. Info Displayed...
  783.  
  784. When you have the pointer over the Tick Box you want to copy, it will 
  785. display the...
  786.  
  787. Zone number
  788. Xstart/Ystart
  789. Xfinish/YFinish
  790. Type of Gadget as a (Tick Box) 
  791. Tick On/Off (Whether the tick is on or off on startup)
  792. Tick Tick/Block (Whether the tick is a Tick or Block)
  793.  
  794. Copying a Tick Box..
  795.  
  796. Click on the Tick Box with your left mouse button and hold it down, you will
  797. now be able to move a box (The same size as the Tick Box) around 
  798. the screen. When you have the Tick Box in the right place let go of the left
  799. mouse button and it will be placed on the screen.
  800.  
  801. (This copies the prefs of that tick box (Tick On/Off)(Block/Tick) etc.
  802. Editable with the edit funtion, explained earlier on)
  803.  
  804. **************
  805.  
  806. Sliders (Horozontal/Vertical):
  807.  
  808. Info Displayed...
  809.  
  810. When you have the pointer over the Slider you want to copy, it will 
  811. display the...
  812.  
  813. Zone number
  814. Xstart/Ystart
  815. Xfinish/YFinish
  816. Type of Gadget as a (H/V Slider) 
  817. No. Divisions (The number of divisions in that slider)
  818. Start Pos. (The Position of the slider at the start of the finished prog)
  819.  
  820. Copying a Slider..
  821.  
  822. Click on the Slider with your left mouse button and hold it down, you will
  823. now be able to move a box (The same size as the slider) around 
  824. the screen. When you have the slider in the right place let go of the left
  825. mouse button and it will be placed on the screen.
  826.  
  827. (This copies the prefs of that slider (No. Divs / Start pos) Editable via
  828. the edit funtion, explained later.)
  829.  
  830. *********
  831.  
  832. Copying text/numric zones:
  833.  
  834. This is identical to the others, but you have to re-enter the default text
  835. etc.
  836.  
  837. *********
  838.  
  839. Copying a H/Vscroller:
  840.  
  841. This is exactly the same as copying a slider, but if also copies the 
  842. scroller arrows. 
  843.  
  844. ***************************************************************************
  845.  
  846. Palette (Change the palette) (Key shortcut (P))
  847.  
  848. Click on the icon, and a screen will appear with 3 sliders, 4 colour 
  849. buttons and 3 function buttons.
  850.  
  851. Move the three sliders up and down to change either (R=Red)(G=Green)
  852. (B=Blue) shades. Click on the colour buttons (To the right), to choose
  853. which colour to change.  
  854.  
  855. You will also see, 3 other buttons, 
  856.  
  857. L:
  858.  
  859. Asks you to load a palette set (.col)
  860.  
  861. S:
  862.  
  863. Asks you to save a palette set (.col)
  864.  
  865. OK:
  866.  
  867. Returns you back to GUIAmos
  868.  
  869. ***************************************************************************
  870.  
  871. MENU (Creates menus for your program (written in GUIAmos!)) 
  872. (Key shortcut (m))
  873.  
  874. Click on it's icon, and you will be displayed with a screen containing 
  875. 3 sliders and 3 text Edit zones...
  876.  
  877. ******
  878.  
  879. Menu Title (Text Zone):
  880.  
  881. This is where you type the Title of each of your menu's.
  882.  
  883. eg.
  884.  
  885.  
  886. Project  Prefs  Colour  Palette
  887.  
  888. ******
  889.  
  890. Menu no. (Slider):
  891.  
  892. This where you choose which menu title (Above) to edit
  893.  
  894. eg. 
  895.  
  896.    1       2      3        4    
  897. Project  Prefs  Colour  Palette
  898.  
  899. 1=Project
  900. 2=Prefs
  901. etc..
  902.  
  903. ******
  904.  
  905. Item (Text Zone):
  906.  
  907. This is where you type the Item that goes under each of your menu's titles.
  908.  
  909. e.g
  910.  
  911. The first menu title could look like this...
  912.  
  913.       1       
  914.    Project  
  915. 1   Load
  916. 2   Save
  917. 3   Save as
  918. 4   Page
  919. 5   Page Size
  920. 6   Screen Format
  921. 7   About
  922. 8   Colours
  923. 9   Image Processing
  924. 10  Somthing else! 
  925. 11  Quit
  926.  
  927. ******
  928.  
  929. Item No. (Slider)
  930.  
  931. This where you choose which Item under each title (Above) to edit.
  932.  
  933. ******
  934.  
  935. Sub Item (Text Zone)
  936.  
  937. This is where you type the Sub Item that can go under each of your menu's 
  938. Items.
  939.  
  940. e.g
  941.  
  942. The first menu title and item could look like this...
  943.  
  944.       1       
  945.    Project  
  946. 1   Load    Iff
  947. 2           Jpeg
  948. 3           Gif 
  949. 4           Psx
  950. 5           Etc.
  951. 6           Etc.
  952. 7           Etc.
  953.  
  954. ******
  955.  
  956. Sub Item No. (Slider)
  957.  
  958. This where you choose which Sub Item under each Item (Above) to edit.
  959.  
  960. So to create a menu you have to first define a title for that menu, then 
  961. the items that are below it and if you want you can define sub items for 
  962. each of the items!
  963.  
  964. When you have finished, if you click on OK, you will be able to test your
  965. menus, when you have finished press the left mouse button to return back
  966. to GUIAmos.
  967.  
  968. If you want to destroy your menus, click on Erase (in the menu editor), 
  969. it will ask if you are sure and then erase them.
  970.  
  971. ***************************************************************************
  972.  
  973. CLR ALL: (Clears the screen)
  974.  
  975. Click on the Icon and it will ask you if you are sure, if you select yes
  976. it will destroy all of the zones and clear the screen.
  977.  
  978. It will also ask if you want to clear the menus (Same as above!)
  979.  
  980. ***************************************************************************
  981.  
  982. U (Undo the last) (Key shortcut (u))
  983.  
  984. If you click on this it will clear the last thing that you created.
  985.  
  986. ***************************************************************************
  987.  
  988.  
  989. Quits the program
  990.  
  991. **************************************************************************
  992.  
  993. The Tiny (T),(B),(L),(R) Icons on the right are explained along with
  994. the H/VSCROLL gads.
  995.  
  996. **************************************************************************
  997.  
  998.  
  999. The text next to the icons I have just explained, are to display...
  1000.  
  1001. TICKS = This displays the number of Tick Box's on the Drawing screen.
  1002.  
  1003. BUTTONS = This displays the number of Buttons on the drawing screen.
  1004.  
  1005. HSLIDER = This displays the number of Horozontal Sliders on the drawing 
  1006.           screen.
  1007.  
  1008. VSLIDER = This displays the number of vertical Sliders on the drawing 
  1009.           screen.
  1010.  
  1011. T EDITS = the number of Text edit zones you have created.
  1012.  
  1013. N EDITS = The number of Numric Edit Zones you have created.
  1014.  
  1015. GETFILES = The number of getfiles you have created.
  1016.  
  1017. TOGGLES = The number of Toggle gadgets you have created.
  1018.  
  1019. ZONES = This displays the number of gadgets on the drawing screen
  1020.  
  1021. TICK = This displays whether the tick is (ON / OFF)
  1022.  
  1023. MENUS = This displays whether the Menus are on.
  1024.  
  1025. XPOS = The X position of the mouse pointer 
  1026.  
  1027. YPOS = The Y position of the mouse pointer 
  1028.  
  1029. XSIZE = The Xsize of the gadget being drawn
  1030.  
  1031. YSIZE = The Ysize of the gadget being drawn
  1032.  
  1033.  
  1034. ***************************************************************************
  1035.  
  1036. How to move the screen:
  1037.  
  1038. If you press the right mouse button, when you are on the drawing screen
  1039. and it will toggle the icon screen on and off.
  1040.  
  1041. If you press the space bar, the screen will move from the top too the 
  1042. bottom of the screen and vice-versa.
  1043.  
  1044. ***************************************************************************
  1045.  
  1046. MISC:
  1047.  
  1048. If you are creating any of the gadgets and decide that the start positon 
  1049. is in the wrong place (Before you have let go of the left mouse key), you
  1050. can abort and try again if you press the space bar.
  1051.  
  1052. ***************************************************************************
  1053.  
  1054.  
  1055. ABOUT THE FINISHED CODE:
  1056.  
  1057. When all of the gadgets are present, these are the routines that each 
  1058. gadget uses.
  1059.  
  1060. Buttons...
  1061.  
  1062. DEFINE: This routine places the lines on the screen for the button
  1063. OFF: This routine resets the button to it's normal state
  1064.  
  1065. Tick Box...
  1066.  
  1067. _TICK: This places a tick on the screen
  1068. _UNTICK: This turns off the tick
  1069.  
  1070. Sliders...
  1071.  
  1072. H/VSLIDER: This works out the position of the slider and updates it
  1073.  
  1074. Scrollers...
  1075.  
  1076. _V/HSCROLLER: This finds the side that the mouse is on up/down, and
  1077.               updates the slider.
  1078.  
  1079. GetFiles...
  1080.  
  1081. FILE: This brings up a file requester, and stores the file
  1082.  
  1083. Toggles...
  1084.  
  1085. SHIFT: This redraws the toggle gad, with the new text.
  1086.  
  1087. >>>>>>>>>>>
  1088.  
  1089.  
  1090. If the gadget has an identifying number for that type of gadget it will
  1091. be in brackets, this number is stored in the variable TYPE()....
  1092.  
  1093. Here are the I.D's of each gadget that are stored in the TYPE() variable.
  1094.  
  1095. Gadget...           I.D
  1096.  
  1097. Button (Thin)       (1)
  1098. Tick Box         (4)
  1099. Horozontal Slider   (6)
  1100. Vertical Slider     (7)
  1101. Get File         (23)
  1102. Hscroller        (34)
  1103. Vscroller        (35)
  1104. Edit zone        (20)
  1105. Numric Edit Zone    (21)
  1106. Toggles            (22)
  1107. Button (Thick)      (80)
  1108.  
  1109. etc..
  1110.  
  1111. When you have saved the code, you can import it into amos as ASCII text,
  1112.  
  1113. It also saves out an iff image of the GUI, which is required, if you want 
  1114. to add any more text, or graphics to the interface, just use a good
  1115. paint package.
  1116.  
  1117.  
  1118. ***************************************************************************
  1119.  
  1120. WHO DUNNIT!
  1121.  
  1122. Coding by Andrew Fisher
  1123. Graphics By Andrew Fisher
  1124. Testing By Matthew Oaks (Moax The Hoax)
  1125. The pain in the #?!*# Sooty the Poodle (Yes I know!, we have a poodle
  1126. someone had to buy them)
  1127.  
  1128. This program took me quite a while, on and off, the finished code is
  1129. 4360 lines long
  1130. With over 7040 instructions 
  1131. And over 210170 Characters!
  1132. So is bound to have some hidden bugs
  1133.  
  1134. If you find any bugs, small things that really anoy you or any new ideas
  1135. for GUIAmos.  If it is a bug or anoyance please tell me where it happens
  1136. what it does, your machine +add ons, version of Amos, and other important
  1137. things. 
  1138.  
  1139. Andrew Fisher
  1140. Ingleside
  1141. 60 Burgh Lane
  1142. Mattishall
  1143. E Dereham
  1144. Norfolk
  1145. NR20 3QR
  1146.  
  1147. WHY!
  1148.  
  1149. Because I wanted too OK!
  1150.  
  1151. ON WHAT:
  1152.  
  1153. I used the excelent....
  1154.  
  1155. Amiga 1200 (Come on ESCOM get some new'uns out now!!!!)
  1156. Blizzard 1220/4 (From Gordon Harwood Computers)
  1157. Overdrive (420 MB HD) (From Special Reserve)
  1158. Amos Pro (Of Course!) (Europress Software Ltd)
  1159. CED (Cygnusoft Software)
  1160. Philips CM8833 MKII (From Philips)
  1161. Panasonic KXP2123 (From Panasonic)
  1162. Dpaint (Electronic Arts)
  1163.  
  1164. >>>>>>>>>>>>>>
  1165.  
  1166. DISCLAMER:
  1167.  
  1168. The author cannot be held liable for the suitability or accuracy of GUIAmos
  1169. Any damage directly or indirectly caused by the use or misuse of GUIAmos
  1170. is the sole responsibility of the user her/him self.
  1171.  
  1172.  
  1173. HELLO...
  1174.  
  1175. ...To one of my Amigan friend's in Austrailia (Paul England)
  1176. ...To Matthew Oaks (MOAX), Dom, Becca Haig, Martin Herrmann
  1177. ...And many others..